식별자 관리
식별자 관리 화면에서는 API 호출을 구분·추적하기 위한 식별자(Identifier)를 슬롯 단위로 등록·관리합니다.
식별자를 등록하면 변환 로그에서 어떤 업무 요청인지 구분해 확인할 수 있습니다. 라이선스에 할당된 식별자 수(쿼터) 범위 내에서 등록할 수 있으며, 등록 시 식별자 코드가 발급됩니다.
1. 목록 화면
1. 식별자 등록
- 신규 식별자 등록 패널을 엽니다.
2. 활성 여부 필터
- 전체 / 활성 / 비활성으로 목록을 필터링합니다.
3. 라이선스 수 / 등록 수
- 쿼터 대비 현재 등록 현황을 표시합니다.
4. 목록
- 등록된 식별자가 테이블로 표시됩니다. 행을 클릭하면 우측 상세 패널이 열립니다.
5. 식별자 코드
- 발급된 코드는 일부만 표시되며, 우측 복사 버튼으로 전체 값을 복사합니다.
1.1 목록 테이블 구성
| 칼럼 | 설명 |
|---|---|
| NO | 순번 |
| 식별자 이름 | 식별자의 이름 |
| 설명 | 식별자에 대한 설명 |
| 식별자 코드 | 발급된 코드 (마스킹 표시, 복사 버튼 제공) |
| 활성 여부 | 활성 / 비활성 (칩으로 표시) |
| 등록일 | 최초 등록 일시 |
| 수정일 | 마지막 수정 일시 |
1.2 목록 화면 기능
| 기능 | 설명 |
|---|---|
| 식별자 등록 | 신규 식별자 등록 패널 열기 |
| 활성 여부 필터 | 전체 / 활성 / 비활성 필터 |
| 검색 | 식별자 이름으로 검색 |
| 라이선스 수 / 등록 수 | 우측 배지로 쿼터 대비 등록 현황 표시 |
| 식별자 코드 복사 | 목록의 복사 버튼으로 코드 복사 |
| 상세 보기 | 행 클릭 시 우측 상세 패널 열기 |
2. 식별자 등록
식별자 등록 버튼을 클릭하면 우측에 등록 패널이 열립니다.
| 입력 항목 | 설명 | 제약 |
|---|---|---|
| 식별자 이름 | 식별자의 이름 | 필수, 중복 불가 |
| 설명 | 부가 설명 | 선택, 최대 200자 |
| 활성 여부 | 활성/비활성 토글 | 기본값 활성 |
동일한 이름의 식별자는 중복 등록할 수 없습니다. 등록 수가 식별자 라이선스 한도를 초과하면 등록이 제한됩니다.
2.1 식별자 코드 발급
등록이 완료되면 식별자 코드 발급 안내 창이 표시됩니다. 발급된 식별자 코드는 API 호출 시 요청을 구분·태깅하는 데 사용됩니다. 식별자 코드는 상세 화면에서도 다시 확인할 수 있습니다.
3. 상세 보기 및 수정
목록에서 식별자를 클릭하면 우측 상세 패널이 열립니다.
| 항목 | 수정 가능 여부 |
|---|---|
| 식별자 이름 | 읽기 전용 |
| 설명 | 수정 가능 |
| 식별자 코드 | 읽기 전용 (복사 가능) |
| 활성 여부 | 수정 가능 |
| 등록된 날짜 / 수정된 날짜 | 읽기 전용 |
설명·활성 여부를 변경한 뒤 저장 버튼으로 반영합니다. 식별자를 비활성화하면 해당 식별자의 API 호출 태깅이 차단됩니다.
4. 식별자 삭제
상세 패널 또는 목록 행에서 삭제 를 선택합니다. 확인 창에서 삭제를 확정합니다.
식별자를 삭제하면 해당 식별자의 신규 API 호출 태깅이 불가합니다. 삭제된 식별자는 복구할 수 없습니다.